home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / last210.zip / LAST.DOC < prev    next >
Text File  |  1991-11-05  |  11KB  |  257 lines
  1. ┌────────────────────────────────────────────────────────────────────────┐
  2. │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ LAST v2.10 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  3. └────────────────────────────────────────────────────────────────────────┘
  4.  
  5.    Todays callers bulletin maker for RemoteAccess v1.10+ and FrontDoor.
  6.  
  7. What is LAST?
  8. ────────────────
  9.  
  10. LAST is a little program that writes bulletin showing todays callers on a
  11. RemoteAccess Bulletin Board Systems. It also includes in the bulletin all
  12. incoming/outgoing FidoNet mail calls made with FrontDoor as a mailer.
  13. Optionally it can also show up to the last 150 callers before today on your
  14. system and show up to 9 days back in FidoNet calls.  LAST can be used on RA
  15. systems that do not use FrontDoor, but then only the last xx callers database
  16. makes it better than the built in todays callers list in RA.
  17.  
  18. In order for it to run properly you must run LAST.EXE before calling the
  19. mailer in your batch file after a caller has exited from the system and after
  20. a mail event has happened.
  21.  
  22. Here is a demo of a batch file that runs RA, FD and LAST.
  23.  
  24.    :Loop
  25.     LAST
  26.     RA -m\FD\Fd.exe*M -E20 -N1
  27.     < Insert your stuff here >
  28.     Goto Loop
  29.  
  30. LAST makes three bulletins in your textfile directory, ONTODAY.ANS,.ASC and
  31. .AVT to provide compatibility for RemoteAccess version 1.00 and later. ANS is
  32. for ANSI, ASC for ASCII and AVT for AVATAR.  LAST finds your BBS Name and
  33. Sysop name in CONFIG.RA and also checks there to see if SysOp should be
  34. excluded from the list.
  35.  
  36.  
  37. What you need to run LAST.
  38. ────────────────────────────────
  39.  
  40. Simple. LAST will _ONLY_ operate correctly on system running MS-DOS 3.xx or
  41. higher with RemoteAccess and FrontDoor installed.  LAST will work on systems
  42. that have only RA installed but not on systems that have only FD.  It needs
  43. the combination of both to function as it should and as it was intended to run.
  44. Last currently works on systems running RA 1.10 and FD 1.99c-2.02.
  45. I can guarantee nothing about compatibility in future releases of those
  46. programs.
  47.  
  48. How to run LAST.
  49. ────────────────────────
  50.  
  51. You must run LSETUP.EXE before you can use LAST and everything there should
  52. be pretty self explanatory...
  53.  
  54. Here is a short list of the main options in LSETUP:
  55.  
  56. [1] Name of bulletin to make
  57.  
  58. This option allows you to change the name of the Bulletin LAST makes.
  59. Default is ONTODAY
  60.  
  61. [2] Name of database to make
  62.  
  63. This option allows you to change the name of the database LAST makes.
  64. Default is LASTDAYS.DBF
  65.  
  66. [3] Exclude FD information
  67.  
  68. If you have only a RA system, then use this to disable the FD part of LAST.
  69. The LAST will work only as any other "todays caller" program, except that it
  70. does of course show calls from the caller database.
  71.  
  72. [I] Name of inbound history file  [FD]
  73.  
  74. Default is INBOUND.HIS in your FD directory
  75.  
  76. [O] Name of outbound history file [FD]
  77.  
  78. Default is OUTBOUND.HIS is your FD directory
  79.  
  80. [4] Hide users real address
  81.  
  82. Show "** Confidential **" as address instead of real address.
  83.  
  84. [5] Show users handle
  85.  
  86. Show users handles instead of real names.
  87.  
  88. [6] Show cost of outbound calls
  89.  
  90. Override the standard output for outbound FD calls and display
  91. session cost, received and sent bytes plus a total of all instead
  92. location of system called.  Point numbers are NOT shown.
  93.  
  94. [7] Exclude Hidden callers
  95.  
  96. Callers with hidden flag ON are displayed.
  97.  
  98. [8] Show callers point number
  99.  
  100. Include systems point numbers in FidoNet calls.
  101.  
  102. [9] Show local logons at what speed
  103.  
  104. This is a sort of 'cheat' option as you can show 0 baud logons as 300-38400bps
  105. logons if you want to...
  106.  
  107. [A] Show FidoNet calls for how long
  108.  
  109. Include FidoNet Calls for x days in list. Maximum = 9 days.
  110.  
  111. [B] Show number of callers from database
  112.  
  113. Show last x callers before today on the BBS. Maximum = 150 callers.
  114.  
  115. [0] Modify prompts in bulletin
  116.  
  117. Here you get a option that allows you to change the headers in the bulletin
  118.  
  119. [*] Modify text in bulletin
  120.  
  121. Here you get a option that allows you to change all other texts displayed in
  122. bulletin.  0 and * are handy if you want to change the language of the
  123. Bulletin made.
  124.  
  125. General stuff.
  126. ──────────────────
  127.  
  128. LAST is *NOT* public domain. It is shareware and therefore you must register
  129. it.  You must register by sending a postcard to me telling me you are using
  130. the program.  You are allowed to makes as many copies of LAST as you want and
  131. distribute it freely as long as you don't charge anything for it except the
  132. cost of the diskette, if you provide it :-)  However if you ever feel the need
  133. to support a starving student then you can send large amounts of money to the
  134. address below :-)  LAST doesn't have any guarantees. If it ruins something on
  135. your system I can never be held responsible for it. Before you run LAST for the
  136. first time you must be sure of that you are doing it on your own. But it should
  137. work!  Also LAST does not write to any files except those ONTODAY files so
  138. nothing much _SHOULD_ go wrong.  I would never have finished this program
  139. without the help and endless bug hunting of John Barton, Mark Kerr and Barry
  140. Phillips.  They found bugs almost every where and thanks to them I think
  141. this version is mostly harmless - I think :-)  LAST was the original program
  142. that showed both mailer and bbs calls in one file.  Only one public version
  143. of LAST has been released outside the RA beta test team cycle, version 1.30.
  144. The changes in version 2.10 are so many that it's impossible to mention them
  145. all.  The reason why versions 1.50 to 2.03 have not been seen is the constant
  146. changes that RemoteAccess structures have undergone since I began to have
  147. access to them.  Therefore I decided to wait until RA 1.10 was released and
  148. release versions of all my programs that were 100% compatible with that
  149. version.  Hope you enjoy the programs.
  150.  
  151. Good luck
  152.  
  153. Hilmar Thors
  154. The Travelling Frobozz BBS
  155. 14 Alexandra Drive,
  156. Wivenhoe,
  157. Colchester,
  158. Essex CO7 9SE,
  159. ENGLAND.
  160.  
  161. FidoNet@2:257/15
  162.  
  163.  
  164.                                  Appendix A
  165.  
  166.                          About the LASTDAYS.DBF file.
  167.  
  168.  
  169. NOTE: This text is taken straight the docs with one of the betas, therefore
  170. it is not very well written, but because of lack of time I will include it.
  171.  
  172. At midnight, it should do something rather devious to your computer.  To tell
  173. you the facts if checks if there is a LASTDAYS.DBF file in your RA directory.
  174. If it exists then it reads the file into memory, the dumps it along with the
  175. contents of LASTCALL.BBS into a new LASTDAYS.DBF file.  If LASTDAYS.DBF does
  176. NOT exist then it makes one for you.  In LASTDAYS. DBF it stores the following
  177. information:
  178.  
  179.                      Line           : Line number of caller
  180.                      Name           : Name of caller
  181.                      Handle         : Callers handle [from USERSXI.BBS]
  182.                      City           : Location of caller
  183.                      Baud           : Speed of caller
  184.                      Times          : Number of times he has called
  185.                      LogOn          : Time of logon
  186.                      LogOff         : Time of logoff
  187.                      Date           : Date of call
  188.  
  189. Every day, the first time LAST is run after midnight it adds this info
  190. to your LASTDAYS.DBF file and thus making a database of all your callers for
  191. since you began using LAST.  Don't worry about the size of the file, it
  192. should only be about 120 bytes per caller, so after 100 callers the size is
  193. 12 K and after 1000 callers 120K.
  194.  
  195. Now why am I doing this?  The reason is simple.  If you want to see who called
  196. last x days ago, or more simply the last 100 (or any number) callers before
  197. today then you use LASTDAYS to do it.  RA does not store that info in any other
  198. file than in RA.LOG and I DON'T want to touch that file as then things can first
  199. begin to go wrong.  I think LAST will work properly.  It does NOT write the
  200. data in LASTDAYS.DBF in ONTODAY now, first I want to know if the database is
  201. working alright.
  202.  
  203. What can go wrong?  Well, there is only one thing that I can think of.  LASTDAYS
  204. .DBF will NOT be made if LAST is NOT run before a caller enters the system
  205. after midnight.  If you run LAST before you start the mailer, then nothing
  206. can go wrong.  The reason for this is that LAST reads the data from
  207. LASTCALL.BBS but when a caller logs on after midnight LASTCALL.BBS is deleted.
  208.  
  209. Now there is one thing that I really like about this.  I would like to see a
  210. complete list of callers that have called since I started Frobozz.  In that
  211. case, if I had run LAST from start the LASTDAYS.DBF file would be about
  212. 1 meg in size.  One meg - and I would have all the info I need in it.
  213. Compared to the size of things that I keep around the BBS I don't think
  214. that is much for all the data that is there.  But of course that's optional,
  215. and purging the file after it has reached 100 calls or 5 days or whatever will
  216. be possible - when I write the util!
  217.  
  218.  
  219.                                 Appendix B
  220.  
  221.                       The utils that come with LAST
  222.  
  223. READLC - This file allows you to view your lastcall.bbs file (that is todays
  224.          callers) offline.  I use it as a function key in FroDo to view how
  225.          has been online today, so I don't have to log on to check.
  226.  
  227.          Syntax:  READLC {-s}
  228.                   -s : Optional, excludes the sysop from the list.
  229.  
  230. READLD - This one allows you to view the lastdays.dbf file that LAST
  231.          has made for you.
  232.  
  233.          Syntax:  READLD {-sh}
  234.                   -s : Optional, excludes the sysop from the list.
  235.                   -h : Optional, shows users handles instead or real names.
  236.  
  237.  
  238. LAMA is a purging util for LAST.  For summary of what LAMA does just type
  239. LAMA.  It does of course not work unless you have the LASTDAYS.DBF database
  240. file in you ra directory.  So don't run this until LAST has made that one for
  241. you.
  242.  
  243. Here is the general summary of what it does (from the source :-)
  244.  
  245.    ■ There are only purging options:
  246.  
  247.     -NOSYSOP : Removes all occurrences of the sysop name in the file.
  248.     -DELETEn : Deletes the first n users from the file. Note if you specify
  249.                to high number LAMA will not do anything.  You must leave at
  250.                least 10 callers in the file.  This is a safety measure.
  251.     -LEAVEn  : Deletes all but the n last callers.  The same as before applies
  252.                here, you must at least leave the last 10 callers.  If you want
  253.                to leave fewer then there is no real need for LAMA, you can as
  254.                well delete the LASTDAYS.DBF file.
  255.  
  256.     ■ NOTE : You can only use one of those options at time.
  257.